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JAVA EMBEDDED SERVER MODULE FOR FORTE FOR JAVA 1M IDE 

FIELD OF THE INVENTION 
This invention relates to the field of software development tools. 

BACKGROUND OF THE INVENTION 

The basic functionality of a computer is dictated by the type of operating system it 
uses. Various operating systems exist in the market place, including Solaris from Sun 
Microsystems, Macintosh from Apple Computers, the "Windows" Operating Systems, 
e.g., Windows 95/98 and Windows NT, from Microsoft, and Linux. The different types 
of operating systems will be referred to herein as "platforms". Prior to the popularity of 
the Internet, software developers wrote programs specifically designed for individual 
platforms. Thus, a program written for one platform could not be run on another. 
However, the advent of the Internet made cross-platform compatibility a necessity. 

Prior art Figure 1 illustrates a conceptional arrangement wherein a first computer 
(3) running the Solaris platform and a second computer (5) running the Windows 98 
platform are connected to a server (9) via the internet (7). A resource provider using the 
server (9) might be any type of business, governmental, or educational institution. The 
resource provider has a need to be able to provide its resources to both the user of the 
Solaris platform and the user of the Windows 98 platform, but does not have the luxury 
of being able to custom design its content for the individual platforms. 

The Java™ programming language was developed by Sun Microsystems to 
address this problem. The Java™ programming language was designed to be simple for 
the programmer to use, yet able to run securely over a network and work on a wide range 
of platforms. 

Referring to Figure 2, in order to create a Java™ application, the developer first 

writes the application in human-readable Java™ source code. As used herein, the term 

"application" refers to both true Java™ applications and Java™ "applets" which are 

essentially small applications usually embedded in a web page. In the example shown, 

l 
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the application "Program" (1 1) is created as a human-readable text file. The name of this 
text file is given the required five-character extension " java ". 

The Java™ compiler or "javac" (13) is used to compile the source code into a 

TM 

machine-readable binary file (15). The text file will contain Java language commands, 

TM 

e.g., "import java.awt. frame" A discussion of the Java language itself is beyond the 
scope of this document. However, complete information regarding the Java™ 
programming language and the Java™ platform are available from Sun Microsystems 
both in print and via the internet at java.sun.com. The resulting binary file (15) will 
automatically receive the same file name as the source text file, but will use ".class" as 

TM TM 

the trailing extension. The Java runtime environment incorporates a Java "virtual 
machine" (JVM) (16) to convert the ".class" byte codes into actual machine executions 
(17). The machine executions (like drawing windows, buttons, and user prompt fields) 
will occur in accordance to the application developer's code instructions. Because Sun 
Microsystems specifically designed the JVM (16) to run on different platforms, a single 
set of ".class" byte codes will execute on any platform where a JVM (16) has been 
installed. An Internet browser such as Netscape and Microsoft Explorer that incorporates 
a JVM (16) is called a "java-enabled" browser. 

The cross-platform architecture of the Java™ programming language is illustrated 

TM 

in Figure 3, which shows how the Java language enables cross-platform applications 
over the Internet. In the figure, the computer (3) running the Solaris platform and the 
computer (5) running the Windows 98 platform are both provided with the JVM (16). 
The resource provider creates a Java™ application using the Java™ software development 

TM 

kit ("SDK") (23) and makes the compiled Java byte codes available on the server (9), 
which in this example is running on a Windows NT platform. Through standard internet 
protocols, both the computer (3) and the computer (5) may obtain a copy of the same byte 
code and, despite the difference in platforms, execute the byte code through their 
respective JVM. 
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As the popularity of the Internet has increased, users have become accustomed to 
many different types of interfaces. Thus, aesthetic conformity has become less of an 
issue. At the same time, speed, functionality, and versatility have become increasingly 
important. Therefore, the Java™ 2 standard edition SDK includes a new "package" for 

5 the developer called "swing" that is essentially library of "lightweight components". 
This new package is simply one library that is possible; other libraries may be created 
and in fact are available from third parties. Swing provides the developer with the option 
and flexibility to use lightweight components and thus improves performance in a given 
application. A detailed discussion of the use of the Java™ abstract windowing toolkit 

10 (AWT) and the Swing package is beyond the scope of this document. Complete 
documentation is available from Sun Microsystems both in print and at the web site 
java.sun.com. 

Forte™ for Java™ products (90), formerly called NetBeans, are visual 
programming environments written entirely in Java™ and Swing. These products are 

15 commonly regarded as the leading Integrated Development Environment (IDE). IDEs 
are easily customizable and extensible, as well as platform independent, as is illustrated 
in Figure 5. Forte™ for Java™ (90) includes a powerful Form Editor (92), integrated full- 
featured text editor (94), visual GUI design (96), debugger (98), and compiler (100). 
Forte™ for Java™ (90) is also completely modular. Also, Forte™ for Java™ (90) is built 

20 around a set of Open Application Programming Interface (API's) which allow it to be 
easily extensible. This means that the IDE functionality for editing, debugging, GUI 
generation, etc. is represented in modules that can be downloaded and updated 
dynamically as is illustrated in Figure 5. Instead of waiting months for a completely new 
release, as soon as new versions (104) or new modules (106) are available, users can 

25 update that individual version or module via the Update Center (102). 



3 



PATENT APPLICATION 
ATTORNEY DOCKET NO.: P5505/1 4695.007001 



SUMMARY OF THE INVENTION 
In one aspect, the invention is an apparatus and a method for facilitating the 
development of Java Embedded Server bundles, which includes a module containing a 
set of development tools used in the creation of Java Embedded Server bundles. 
5 In one or more embodiments, the module may be adapted for inclusion in an 

Integrated Development Environment (IDE), the module may be accessible via a drop- 
down menu, and the module may be updated via an update mechanism while included in 
the IDE. 

In one or more embodiments, the module may include a code template tool having 
10 sample code segments; a Java Embedded Server manifest generator tool that creates Java 
Embedded Server manifest files for Java Embedded Server bundles; a Java Embedded 
Server jar packager tool that packages Java Embedded Server bundles; and a web page 
link tool having links to Java Embedded Server-related web pages. 

15 BRIEF DESCRIPTION OF THE DRAWINGS 

Figure 1 illustrates a multiple platform environment. 

TM 

Figure 2 illustrates a mechanism for creating Java applications. 

TM 

Figure 3 illustrates a Java application running in a multiple platform 
20 environment. 

Figure 4 illustrates a typical computer and its components as they relate to the 

Java virtual machine. 

Figure 5 illustrates a Forte™ for Java™ Integrated Development Environment 

(IDE) 

25 Figure 6 illustrates a Java Embedded Server module in accordance with one 

embodiment of the present invention. 

Figure 7 is a flowchart illustrating a process in accordance with one embodiment 
of the present invention. 

4 
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Figure 8 is a computer screen shot illustrating the drop-down menu in accordance 
with one embodiment of the present invention having a Manifest Generator, a JAR 
Packager, and Product Info and Downloads submenus. 

Figure 9 is a computer screen shot illustrating a Code Template tool dialog box in 
accordance with one embodiment of the present invention. 

Figure 10 is a computer screen shot illustrating the Manifest Generator tool dialog 
box in accordance with one embodiment of the present invention. 

Figure 1 1 is a computer screen shot illustrating the JAR Packager tool dialog box 
in accordance with one embodiment of the present invention. 

Figure 12 is a computer screen shot illustrating the JAR Packager tool menu and 
specifically the 'Update JAR Content' menu item in accordance with one embodiment of 
the present invention. 

DETAILED DESCRIPTION OF THE INVENTION 
Specific embodiments of the invention will now be described in detail with 
reference to the accompanying figures. Like elements in the various figures are denoted 
by like reference numerals for consistency. 

The invention described here may be implemented on virtually any type computer 
regardless of the platform being used. For example, as shown in Figure 4 5 a typical 
computer (71) comprising a processor (73), associated memory (75), and numerous other 
elements and functionalities typical to today's computers (not shown). The computer 
(71) may further comprise input means, such as a keyboard (77) and a mouse (79), and an 
output device, such as a monitor (81). Those skilled in the art will appreciate that these 
input and output means may take other forms. Computer (71) is connected via a 
connection means (83) to the Internet (7). The computer (71) is configured to run a JVM 
(16), implemented either in hardware or in software. 

Returning to the Forte for Java Integrated Development Environment (IDE) 
(90) example shown in Figure 5, it would be desirable to have a module to be used within 
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Forte™ for Java™ (90) or any other IDE having all development tools necessary to create 

TM 

Java Embedded Server (JES) bundles in one package. 

TM TM 

Java Embedded Server Module (110) for the Forte for Java IDE (90), as 
shown in Figure 6, contains tools which facilitates creation of Java Embedded Server 
5 bundles. The plug-in module (110) contains a code template tool (112), a Java 
Embedded Server Manifest Generator tool (114) to help in creating a valid Java 
Embedded Server manifest file for the bundle, and a Jar Packager tool (1 16) which helps 
packaging up the bundle. Also, links to web pages (118) containing documentation and 
other information about Java Embedded Server are included. Further, access to Java 

10 Embedded Server Swing-based tools from within the module may be included. 

An embodiment of the plug-in Java Embedded Server module (110) is accessed 
via a drop-down menu in Forte™ for Java™ (90) entitled 'Java Embedded Server' (150) 
as shown in Figure 8. As can be seen, the drop-down menu consists of three submenus 
entitled 'Manifest Generator' (152), 'Jar Packager' (154), and 'Product Info and 

15 Downloads' (156) which provide access to a selected feature of the Java Embedded 
Server module (110) identified by submenu name. The submenus are displayed by 
clicking on the 'Java Embedded Server' menu name (150) with the mouse (79). By 
continuing to hold the mouse button down and dragging the mouse pointer over the 
desired submenu name, the submenu name is selected upon release of the mouse button. 

20 The result of selecting the submenu is the launching of the application to perform the 
selected submenu feature by the system. 

Referring to Figure 7, an example for the usage of plug-in module (110) by a 
bundle-writer for developing Java Embedded Server bundles follows. The bundle-writer 
first uses the Java Embedded Server code template tool to retrieve and organize code that 

25 can be used as a starting point for the remaining development (ST130). The bundle- 
writer then finishes the code for the bundle (ST132) and is ready to package the code to 
be used with the Java Embedded Server Framework. 
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In order to accomplish this, a valid manifest file for the Java Embedded Server 
bundle must be written. The bundle-writer uses the Java Embedded Server Manifest 
Generator tool (114) to create a valid manifest file (ST134). Next, the bundle-writer uses 
the Jar Packager tool (116) to create the bundle's jar file (ST136). The bundle-writer 
5 must then debug the bundle. Using the Forte™ for Java™ debugger (98), the bundle- 
writer can correct any problems that need to be fixed (ST 13 8). Using the supplied links 
within the 'Java Embedded Server' menu (150) to online Java Embedded Server 
documentation (156), the bundle-writer can find the material that may be a resource to 
what changes need to be made (ST142), Further links are contained, including links to 
10 documentation, FAQ's, technical support that can be used by the programmer to come up 
with a solution to the problem. These supplied links may also be used as reference points 
during all stages in the bundle development cycle (ST140). The code is compiled by the 
compiler (100) (ST144) and the bundle-writer can update the jar file content with a click 
g of the mouse (79) (ST146). With the code compiled, the bundle is created and the 

15 process ends (ST148). 

si 

D An embodiment of the Java Embedded Server Code Template tool (112), as 

[7 shown in Figure 9, is used to get a bundle-writer started writing Java Embedded Server 

J3 bundles. The bundle-writer begins using the Java Embedded Server code templates 

(112), which have been provided for the bundle-writer. The Java Embedded Server code 
20 templates are accessed through the 'New From Template' dialog box (160). The 'New 
From Template' dialog box (160) appears when the 'New From Template' menu item is 
selected from Tools' menu (158), similar to any template within Forte™ for Java™ (90). 
As can be seen, the 'Java Embedded Server' folder (164) is listed under the 'Templates' 
folder (162) in the 'New From Template' dialog box (160). In one embodiment, the Java 
25 Embedded Server templates (1 12) comprise the following: 

1) Activator Code (120): A template for writing bundle's Activator class; 

2) Service Interface (122): A template for writing bundle's interface class; and 
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3) Service Implementation (124): A template for writing bundle's 
implementation. 

Once the template file(s) appear in the Forte™ for Java™ Text Editor (94), the 
bundle-writer can begin developing the bundle from sample code. 

An embodiment of the Java Embedded Server Manifest Generator tool (114), as 
shown in Figure 10, is an aid in creating valid manifest files for Java Embedded Server 
bundles. The Manifest Generator (114) saves development time by providing the name 
of each Java Embedded Server manifest header (175) along with the description (170), 
the syntax (172), and an example of the use of the particular manifest header. To start the 
Java Embedded Server Manifest Generator (114), the 'Manifest Generator' menu item 
(152) is selected from the 'Java Embedded Server' menu (150). Two text boxes are 
located near the top of the screen which hold the descriptions (170) and syntax (172) of 
the manifest header (174), a listing of each Java Embedded Server manifest header name 

(175) to the left and its corresponding text field (177) for the Manifest Header Value 

(176) to the right. Also, action buttons (181) appear at the bottom of the screen. 

When first starting the Java Embedded Server Manifest Generator (114), text is 
displayed inside each of the two help boxes at the top of the screen. These help boxes 
display the description (170) and syntax (172) of each manifest header (174). To view 
the help file on a particular manifest header name (175), the name of the particular 
manifest header (175) is selected for the left help box or the corresponding text field 

(177) is selected from the right help box. The selection is made by clicking or tabbing to 
the area. A brief description (170) of the manifest header is displayed in the box labeled 
'Manifest Header Description' (170) and the syntax (172) is displayed in the box labeled 
'Manifest Header Syntax.' 

A particular header name (175) in the generated manifest file is included when the 
header's checkbox (178) is selected. When checking a header (174), the corresponding 
text field background changes from gray to white. The value of the header (174) is 
entered into the text field (177) immediately to the right of the header name (175). 
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Another way to include a header (174) into the manifest file is to type the value into the 
text field (177). As soon as the manifest header value (176) is entered into the text field 
(177), a checkbox (178) gets checked. 

Before or after entering the manifest header values (176), the name of the 
5 manifest file to be generated is selected. If the file already exists, a prompt is given to 
overwrite the existing file. It is recommended to use the extension "*.MF", "*.mf ', or 
"*.txt" when naming the manifest file. The reason is because these extensions are, by 

TM TM 

default, textual obj ects that Forte for Java (90) recognizes. 

After selecting the file name and entering in the manifest header values (176), 
10 selecting the 'Create/Edit' button (171) generates the manifest file. The manifest file is 
2 placed in a file in the text editor (94) to view its contents and/or make any final 

modifications. To generate the file, but not start the editor, the 'Create' button (173) can 
01 be selected. Once the file is generated, a message reflecting the completion is displayed. 

Jil To clear all entered data and start over, the 'Clear' button (175) can be selected. When 

tf? 15 finished, the 'Close' button (179) is used to exit. 

St 

0 In one embodiment of the Java Embedded Server Manifest Generator (114), a 

(2 simple template of all the possible Java Embedded Server 2.0-related manifest headers 

fl! (174) is included. Once the template is chosen, all of the manifest headers (174) are put 

p- into a file in the editor. The bundle-writer fills in the necessary values (176) next to each 

20 header (174) that is being used. In one embodiment, the bundle's source files are parsed 
to generate the entire or at least portions of the manifest file. 

When the bundle-writer is ready to package up the Java Embedded Server bundle 
using the Jar Packager (116), select the contents to be packaged from the Explorer 
window (180) a shown in Figure 11. For example, if the bundle is in the package 
25 com.my.company .bundle, one should select the 'com' folder (184) in the Explorer 
window (180). Either one of the following can be used to start the Jar Packager (116): 
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1) with the mouse (79) on the selected folder, right-click and select 'Add To Jar' 
or select the 4 Jar Packager' menu item (154) under the 'Java Embedded 
Server' menu (150); or 

2) select the 'Jar Packager' menu item (not shown) under the 'Tools' menu 
(158). 

To include the manifest file previously created into the jar file, select 'Load Manifest 
From File' and choose the previously created manifest file. Or, simply copy the contents 
of the file into the area within the 'Manifest' tab (190) of the Jar Packager (116). The Jar 
Packager GUI interface should only be used once as all subsequent versions of the jar file 
can be made by simply right-clicking the mouse (79) on the jar file in the Explorer 
window (180) and selecting the 'Update JAR Content' menu item (182) as shown in 
Figure 12. 

Various embodiments of the invention have been described above using the 
Java™ environment running on a Solaris or Windows native platform. However, the 
methodology described is not limited in its implementation to a particular programming 
language, nor is the inclusion of the Solaris and Windows platform examples intended to 
be limiting as to the types of native platforms on which the invention may be employed. 
Accordingly, the invention is not limited to the particular embodiments or platforms 
described in the exemplary embodiments above, but rather is limited only of the scope of 
the appended claims. 
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